home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / relnotes / cosmocreate / ch5.z / ch5
Text File  |  1998-11-02  |  31KB  |  925 lines

  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        5.  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  9.  
  10.  
  11.  
  12.        5.1  _C_o_s_m_o__C_r_e_a_t_e
  13.  
  14.        The current implementation of Cosmo Create has a few
  15.        limitations, as described in the following sections.
  16.  
  17.  
  18.        5.1.1  _G_e_n_e_r_a_l
  19.  
  20.           +o The localization of Cosmo Create covers the main
  21.             application and the Packager. Certain areas of these
  22.             applications such as the Help menu, and help content
  23.             have not been localized.
  24.  
  25.           +o Due to a bug in PC NFS, Cosmo Create will hang while
  26.             trying to work on files mounted from a PC.  This
  27.             includes opening files from, saving files to and
  28.             browsing such directories.  This problem has been
  29.             reported to the manufacturer of the PC NFS software.
  30.             There is no known workaround.
  31.  
  32.           +o Please install Patch 2715 if your LD_LIBRARY_PATH is
  33.             set to anything longer than around 100 characters.  The
  34.             runtime linker (rld) shipped with IRIX 6.2MR sometimes
  35.             core dumps if your LD_LIBRARY_PATH is too long.
  36.  
  37.           +o Please install Patch 1537 to work around a bug in the
  38.             File Alteration Monitor shipped with IRIX 6.2MR.  The
  39.             visible symptom requiring this patch was that changes
  40.             saved from Helper Applications were not always noticed
  41.             by Cosmo Create.
  42.  
  43.           +o If you have both an evaluation and a permanent license
  44.             in your /var/flexlm/license.dat file, the first one
  45.             matching the product will be found.  Thus, if the
  46.             evaluation one occurs first, you will continue to see
  47.             the expiration notification until the evaluation
  48.             license expires, at which point the permanent one will
  49.             be used.  To avoid this problem once you've obtained
  50.             your permanent license, edit the
  51.             /var/flexlm/license.dat file and remove the evaluation
  52.             one.  See Chapter 6 for more information about
  53.             licenses.
  54.  
  55.           +o If you are running Cosmo Create in the Japanese locale
  56.             please install Patch 2906 included with the Japanese
  57.             World View product to ensure that type-in text fields
  58.             provide a composition window.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.           +o The Spyglass eMosaic browser is run from a shell script
  75.             called eMosaic.  Due to a bug in this script, eMosaic
  76.             will not launch from Cosmo Create unless the following
  77.             line is added to the top of the script: ####!!!! ////bbbbiiiinnnn////sssshhhh.
  78.  
  79.           +o Pressing the "Default" button in preferences should
  80.             clear the values in the Proxy and Cache entries.
  81.             Currently it does not.
  82.  
  83.           +o Cosmo Create does not always correctly undo/redo the
  84.             insertion of a horizontal rule.
  85.  
  86.           +o Insertion of a horizontal rule into preformatted text,
  87.             a list, or a text flow around an inline may not produce
  88.             the expected visual results in all cases.  Use preview
  89.             to determine the actual result.
  90.  
  91.           +o When you delete numerous lines that contain alternate
  92.             HTML, the lines do not join into a single line.
  93.  
  94.           +o The network fetching code for the Netscape plug-in
  95.             architecture is not yet implemented, making plug-ins
  96.             that depend on it unstable.  Also, there is no java
  97.             runtime in Cosmo Create, so plug-ins that depend on
  98.             Java will also be unstable.
  99.  
  100.           +o Cosmo Create may cause your system to run out of swap
  101.             space.  If this happens, you will probably get a system
  102.             error dialog.  Running out of swap space may cause the
  103.             application to crash, may prevent you from launching a
  104.             browser for previewing, or may prevent you from
  105.             launching the packager. If this occurs, consider
  106.             closing down other applications or adding more swap
  107.             space.
  108.  
  109.             To add swap space, choose "System->System Manager" from
  110.             the Toolchest.  On 6.2, you can launch the swap manager
  111.             from the "Administration Tools" panel of the system
  112.             manager.  On 6.3, selecting "System Performance" from
  113.             the system manager will guide you through adding swap
  114.             space.  On either system, you can look at the man page
  115.             for "swap".
  116.  
  117.           +o To insert a paragraph before a left-aligned image at
  118.             the top of a page, make sure that View->Symbols is on,
  119.             position the cursor before the aligned image marker at
  120.             the start of the line and hit return.  The marker looks
  121.             like a little triangular flag pointing left.
  122.  
  123.           +o Pages containing ISO Latin 1 characters outside the
  124.             ASCII range should not be processed by Cosmo Create in
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.             an Asian locale. This limitation is placed on Cosmo
  141.             Create by the character encoding schemes used for Asian
  142.             locales.
  143.  
  144.  
  145.        5.1.2  _T_a_b_l_e_s
  146.  
  147.           +o If a table is the first or last thing in a document,
  148.             and you want to add something above or below it, select
  149.             "Add Paragraph Before Table" or "Add Paragraph After
  150.             Table" from the Format menu. Alternatively, click to
  151.             the left of the table or above it, or the right or
  152.             below it, and when you then start typing, the new text
  153.             will go in a new paragraph automatically inserted above
  154.             or below the table, as appropriate.
  155.  
  156.           +o If a table isn't being drawn completely, slightly
  157.             resizing the document window will usually correct the
  158.             problem.  This may happen particularly after adding a
  159.             table, or adding rows or columns to a table.
  160.  
  161.           +o Undoing some table operations may not work correctly.
  162.             Sometimes undoing an edit of a nested table, or a
  163.             deletion of a table immediately above another table may
  164.             change the nesting structure.  If this happens, the
  165.             Edit Source function can be used to clean it up by
  166.             hand.  Undoing an edit of a table at the very end of
  167.             the document or undoing an insertion of a table within
  168.             a table may cause Cosmo Create to crash.
  169.  
  170.           +o If you copy a table that contains two immediately
  171.             adjacent sub-tables, the nesting structure may be
  172.             changed.
  173.  
  174.           +o Table cell and caption alignment is not shown WYSIWYG.
  175.  
  176.           +o In a table heading cell (<TH> tag), the text may not be
  177.             displayed bold if it has a character style such as
  178.             <CITE> or <KBD>.
  179.  
  180.           +o The sizing of tables, rows and cells is not exactly the
  181.             same as in Netscape Navigator.  In particular, if a
  182.             cell or a subtable width is specified as a percentage,
  183.             it is draw at that percent of the document's width,
  184.             rather than that percent of the parent table or cell's
  185.             width.  Also, the minimum width of a cell containing a
  186.             left- or right-aligned image is calculated differently
  187.             from how it is done in Netscape Navigator.
  188.  
  189.           +o If a table width is specified as 100%, resizing the
  190.             window may cause the table to be displayed too wide.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.             Also, editing in a wide table may cause it to be
  207.             displayed too wide.
  208.  
  209.           +o A cell can span into the next row only if the cell
  210.             below it spans the same number of columns as the
  211.             original cell.  Likewise, a cell can span into the next
  212.             column only if the cell to the right spans the same
  213.             number of rows as the original cell.  Therefore, for
  214.             example, if you have a table with no spanned cells, and
  215.             want to make one cell span two rows and two columns,
  216.             you have to do it in two steps.  First increase the row
  217.             span of both that cell and the one to its right to 2
  218.             and apply that change, then set the column span of the
  219.             original cell to 2 and apply that change.
  220.  
  221.           +o A table inside a list may not be indented correctly,
  222.             nor will a table with a list item at the beginning of
  223.             the first cell.
  224.  
  225.           +o If there is an ordered list item at the end of a table
  226.             cell, and another at the beginning of the very next
  227.             cell, the numbering of the lists will be combined.
  228.             This can be avoided by putting a plain (Body) paragraph
  229.             between the lists.
  230.  
  231.           +o Cosmo Create requires a table to be in its own
  232.             paragraph. If you try to create a table in the middle
  233.             of a paragraph, it will split the paragraph into two
  234.             pieces, with the table going between them.
  235.  
  236.           +o The cursor may be displayed in the wrong location,
  237.             especially after horizontal scrolling and adding or
  238.             removing table rows or columns.  If this happens, just
  239.             click the cursor in the desired cell to reset its
  240.             position before typing.
  241.  
  242.           +o If you want to delete a subtable within another table
  243.             along with some other table contents, first delete just
  244.             the subtable, then delete the rest.  Otherwise Cosmo
  245.             Create may crash.
  246.  
  247.           +o Deleting and undoing editing involving tables together
  248.             with form elements or list items is somewhat unstable.
  249.  
  250.           +o Sometimes inserting HTML or pasting a copied selection
  251.             containing nested tables into another table will cause
  252.             Cosmo Create to hang.
  253.  
  254.           +o Some table editing actions cause Cosmo Create to use a
  255.             lot of memory.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        5.1.3  _I_n_l_i_n_e_s
  273.  
  274.           +o If you're editing a new, unnamed document, save and
  275.             name it before inserting any inline content.  Also,
  276.             when editing a new file created from a template, save
  277.             the file under a new name before inserting any inline
  278.             content.
  279.  
  280.           +o If you have installed any of the Beta releases of Cosmo
  281.             Create, and experience problems with Button Magic or
  282.             other inline objects not appearing, then you may have
  283.             outdated conversion preferences.
  284.  
  285.             To check for a valid Button Magic converter:
  286.  
  287.             Select File->Preferences and open the "Converting"
  288.             panel.
  289.  
  290.             Find the converter for "CosmoButtonAsciiData." The
  291.             conversion command should read:
  292.  
  293.                     /usr/lib/CosmoCreate/apps/bmrender %i %o
  294.  
  295.             If not, clear the "Conversion Command" field, save the
  296.             preferences, and restart Cosmo Create.
  297.  
  298.             If you are unable to determine which converter is
  299.             failing, you may resort to renaming or removing,
  300.             ".cosmocreate/cosmocreate-preferences" in your home
  301.             directory and starting Cosmo Create again.  Beware! You
  302.             will lose any other preferences you may have saved.
  303.  
  304.           +o For inline plug-ins, the right mouse button is not
  305.             interpreted by the plug-in but is intercepted by Cosmo
  306.             Create to pop up its own menu.
  307.  
  308.           +o Plug-ins don't print.  However, plug-ins don't print in
  309.             Netscape Navigator, either.
  310.  
  311.           +o If two images are adjacent on the same line, and one is
  312.             resized so that it wraps to the following line, it can
  313.             be difficult to position your cursor after the
  314.             remaining image on the previous line.  It will always
  315.             go to the start of the next line.  The workaround is to
  316.             cursor back from the next line.
  317.  
  318.           +o Reacharounds for inline objects are not dealt with
  319.             correctly.  A "reacharound" is when you launch Cosmo
  320.             Create from inside one directory, edit a file in
  321.             another directory, and attempt to make inline objects
  322.             that reside in or below the first directory.  A
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.             workaround is to make URL mappings that match your
  339.             directory structure.
  340.  
  341.           +o If you enter a non-existent file as the source for a
  342.             plug-in, the data filename will not be saved with the
  343.             document in the EMBED tag.
  344.  
  345.           +o There is currently no way to drag-resize a running
  346.             plug-in.  To resize, either enter the new width/height
  347.             in the attributes panel or turn plug-ins off (using the
  348.             View menu) and drag resize its placeholder.
  349.  
  350.           +o Alignment TEXTTOP, ABSMIDDLE, and ABSBOTTOM for inlines
  351.             that are the first thing on the line does not always
  352.             work as expected, though it does work the same way as
  353.             in Netscape Navigator.  They only align with things
  354.             that precede them on the line.
  355.  
  356.           +o When inserting parameters on applet and embed inlines,
  357.             the parameter fields are redrawn slowly.
  358.  
  359.           +o It can be difficult to drag-resize an inline if another
  360.             inline is immediately to the right.  Workaround by
  361.             putting a space in between them, and then removing it
  362.             when you have the inline the right size.
  363.  
  364.           +o It is somewhat difficult to select left and right
  365.             aligned images, especially in tables.  Clicking towards
  366.             their upper left corners seems to work, but an
  367.             alternative method is to View->Symbols and select the
  368.             aligned image placeholder instead.  The placeholders
  369.             appear as small triangular flags in the text that point
  370.             towards the margin the image is aligned with.
  371.  
  372.           +o Sometimes the server and client map fields on the image
  373.             attributes dialog show incorrect info.  The correct
  374.             info is always shown in the Image Map Tool.
  375.  
  376.  
  377.        5.1.4  _O_u_t__o_f__P_l_a_c_e__E_d_i_t_i_n_g__/__A_u_t_o_m_a_t_i_c__C_o_n_v_e_r_s_i_o_n
  378.  
  379.           +o If you try to edit a file you don't have write
  380.             permission on, the file is copied to the current
  381.             document directory.  No attempt is made to copy it to a
  382.             new name in the directory it previously resided in.
  383.  
  384.           +o Automatic conversion always puts the converted file in
  385.             the current document directory rather than trying to
  386.             first put it in the directory in which the original
  387.             source file resides if write permission is granted
  388.             there.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.           +o Some showcase files fail to convert when the last page
  405.             in the showcase document is blank, resulting in either
  406.             a small or invalid GIF file (sometimes the GIF file is
  407.             0 bytes long).  To remedy the problem, open the file in
  408.             showcase, delete the last (empty) page, and try again.
  409.  
  410.           +o There is no cleanup of the auto generated files from
  411.             conversion or copying.
  412.  
  413.           +o Double clicking on inlines doesn't launch an editor, as
  414.             it should.
  415.  
  416.  
  417.        5.1.5  _L_i_n_k_s
  418.  
  419.           +o When you type after a link to continue the linked text,
  420.             sometimes the link does not continue with the new text.
  421.             The workaround is to first delete one character of the
  422.             old text before adding the new text.
  423.  
  424.           +o Cosmo Create does not correctly resolve paths in the
  425.             link dialog.  If you're linking to a file in a parent
  426.             directory of the current directory, Cosmo Create should
  427.             write out the link as ../document.html.  In fact it
  428.             writes out the link as working_directory/document.html.
  429.             A workaround is to manually specify the link as known
  430.             to be correct.
  431.  
  432.  
  433.        5.1.6  _T_a_g_s__a_n_d__T_a_g__O_r_d_e_r_i_n_g
  434.  
  435.           +o Unrecognized attributes on font tags (e.g. B, I, FONT)
  436.             are stripped when an HTML document is read. If these
  437.             tags are meaningful they must be manually placed back
  438.             into the file after it has been saved. Unrecognized
  439.             attributes on all other elements are preserved.
  440.  
  441.           +o Empty HREF anchors are consumed by Cosmo Create but
  442.             empty NAME anchors are preserved by attaching them to
  443.             adjacent markup.
  444.  
  445.           +o Lists in Alternate HTML for Applets can have their
  446.             close tag written outside of the </APPLET> tag, causing
  447.             parser warnings.
  448.  
  449.           +o Cosmo Create will allow multiple consecutive empty
  450.             non-PRE paragraphs.  Most HTML browsers will ignore
  451.             these empty paragraphs. Use line breaks instead of
  452.             empty non-PRE paragraphs for spacing. Paragraphs and
  453.             lines that are ignored by browsers are indicated by the
  454.             paragraph symbol enclosed in square brackets.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                   - 8 -
  467.  
  468.  
  469.  
  470.           +o The BASEFONT tag is not processed and will be displayed
  471.             as unrecognized markup. As a result, any subsequent
  472.             relative font sizes will be relative to the default
  473.             font size, 3, rather than the size specified in the
  474.             BASEFONT tag.
  475.  
  476.           +o The SUB, SUP and DIV tags are not processed and will be
  477.             displayed as unrecognized markup.
  478.  
  479.  
  480.        5.1.7  _I_m_a_g_e__M_a_p_s
  481.  
  482.           +o Clientside imagemaps can be read and written, but the
  483.             map must be in the same HTML file. (That is,
  484.             USEMAP="otherfile.html#foo.map" will not work, and will
  485.             be changed by Cosmo Create).  Also, an HTML file
  486.             contains a clientside map that isn't used by that file,
  487.             the map data will not be written back out.
  488.  
  489.           +o Cosmo Create may add extra empty paragraphs when
  490.             reading a document file containing a clientside
  491.             imagemap. These paragraphs are ignored by browsers.
  492.  
  493.           +o If a document contains a clientside imagemap that is
  494.             not referenced by that document, Cosmo Create will not
  495.             write the map information when it saves the file.
  496.  
  497.           +o If you change the preference for what type of image map
  498.             to write, no map will be written unless you save the
  499.             document.  However, if you have made no other document
  500.             changes, Cosmo Create does not indicate that the
  501.             document needs to be saved.
  502.  
  503.           +o Launch Cosmo Create from the directory where your files
  504.             are; it might not find imagemap files that are in
  505.             directories other than where you launched from.
  506.  
  507.           +o If you edit a document from the web (as opposed to a
  508.             local file), and that document uses serverside
  509.             imagemaps, the map files will not be found, and an
  510.             error dialog will be posted.
  511.  
  512.  
  513.        5.1.8  _F_e_t_c_h_i_n_g
  514.  
  515.           +o If you open a page from the web, and cancel the fetch
  516.             before the page is completely loaded, you must open a
  517.             new window in order to initiate another fetch.
  518.  
  519.           +o The "Browse" feature (see chapter 3) only parses HTML.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                   - 9 -
  533.  
  534.  
  535.  
  536.           +o Saving inline images in web fetched documents can only
  537.             be accomplished by making a modification to the page,
  538.             which causes the "Remote Document Modified" dialog to
  539.             come up, which has a check box that allows you to save
  540.             the inline images.
  541.  
  542.           +o Saving a web fetched page from the Edit Source window
  543.             will not save the inline images.  To get around this,
  544.             save the page from the main document window.
  545.  
  546.           +o Opening Cosmo Create twice on the exact same URL in the
  547.             same editing session causes Cosmo Create to hang.
  548.             Pressing "Cancel" on the Progress meter will unhang the
  549.             program, allowing you to close the window.
  550.  
  551.           +o Occasionally, when downloading a page over the web, the
  552.             page will not layout correctly after the download is
  553.             done.  In these cases, resizing the window will cause
  554.             the page to correctly layout.
  555.  
  556.  
  557.        5.2  _B_u_t_t_o_n__M_a_g_i_c
  558.  
  559.           +o Palettes and Editors
  560.  
  561.             The Material Palette and Texture Editor look for data
  562.             installed in /usr/share/data/materials and
  563.             /usr/share/data/textures, respectively.
  564.  
  565.             If you do not have showcase installed, these editors
  566.             will still function, though no default material
  567.             palettes or textures will be shown.
  568.  
  569.             For best results, you should install showcase.sw.data
  570.             and showcase.sw.textures.
  571.  
  572.           +o International font support.
  573.  
  574.             Button Magic supports international fonts, such as
  575.             Japanese.  However, due to limitations in the
  576.             interface, only the first font in a font list may be
  577.             changed. If you wish to change the font list, you must
  578.             add the font to the button's fontlist by hand.
  579.  
  580.             A sample font has been inserted in each button magic
  581.             file to get you started:
  582.  
  583.                     HonMinchoLtBT--H;HonMinchoLtBT--Hankaku
  584.  
  585.             If you wish to use some font other than the above, you
  586.             must add it by hand to the Button Magic file.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                   - 10 -
  599.  
  600.  
  601.  
  602.             To do so, perform these steps:
  603.  
  604.             1) Create a button by clicking on the "Go" button in
  605.                the Create panel and sweeping out an area on the
  606.                HTML page.
  607.  
  608.             2) When Button Magic appears, select "Change inline
  609.                object" from Cosmo Create's "Editors" palette.
  610.                Launch your favorite text editor on the file
  611.                shown in the "Original File" field.
  612.  
  613.             3) Find the line beginning with the text "fontName" and
  614.                add your fonts to the right of the first semicolon.
  615.  
  616.                Example:
  617.  
  618.                fontName  "Palatino-Roman;HonMinchoLtBT--
  619.             H;HonMinchoLtBT--Hankaku"
  620.  
  621.                To
  622.  
  623.                fontName  "Palatino-Roman;HeiseiMin-W3--
  624.             H;HeiseiMin-W3--Hankaku"
  625.  
  626.             4) Save the file. The button should automatically
  627.                re-render with the new font. If not, launch Button
  628.                Magic on the inline object and press Apply.
  629.  
  630.           +o When a new document has not been saved before, Button
  631.             Magic writes images to the current working directory,
  632.             if writable.  If the current working directory is not
  633.             writable, it will attempt to write the images to the
  634.             user's home directory.  Workaround: save the document
  635.             once before launching Button Magic for the first time.
  636.  
  637.           +o Symbol and Zapf Dingbats fonts are not supported in
  638.             Button Magic.
  639.  
  640.           +o Due to a bug in PC NFS, Button Magic will hang while
  641.             trying to work on files mounted from a PC.  This
  642.             includes opening files from, saving files to and
  643.             browsing such directories.  This problem has been
  644.             reported to the manufacturer of the PC NFS software.
  645.             There is no known workaround.
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                   - 11 -
  665.  
  666.  
  667.  
  668.        5.3  _C_o_s_m_o__P_a_c_k_a_g_e
  669.  
  670.        The current implementation of Cosmo Package (invoked by
  671.        choosing the "Package..." menu choice under the "File" menu
  672.        in Cosmo Create or Cosmo Worlds) has a few limitations.
  673.        Here is the list:
  674.  
  675.        5.3.1  _G_e_n_e_r_a_l
  676.  
  677.          1.  Due to a bug in PC NFS, Cosmo Package will hang while
  678.              trying to work on files mounted from a PC.  This
  679.              includes packaging files from, packaging files to, and
  680.              browsing such directories.  This problem has been
  681.              reported to the manufacturer of the PC NFS software.
  682.              There is no known workaround.
  683.  
  684.          2.  The Packager handles only HTML, VRML 2.0 Draft 3, VRML
  685.              2.0, and Cosmo Worlds files.  All other document types
  686.              are treated as "black boxes" -- they aren't searched
  687.              for references to other local documents, they aren't
  688.              optimized, their references aren't patched -- they are
  689.              merely moved to the packaging directory.  This will be
  690.              most noticeable when you package HTML documents
  691.              containing Java Applets.  Only the main ".class" file
  692.              will be moved.  None of the supporting files will be
  693.              moved.
  694.  
  695.          3.  Cosmo Package relies heavily on the File Typing Rules
  696.              (FTRs) which are installed as part of your desktop.
  697.              If files are not being typed properly, they may not be
  698.              packaged properly.  On each line claiming that a file
  699.              is being discovered or packaged, the packager shows
  700.              the file's FTR type.  If the right thing isn't
  701.              happening to the files, check that the FTR looks
  702.              reasonable.  If it doesn't please talk to your system
  703.              administrator to have your FTRs checked.
  704.  
  705.          4.  Package directories created by the beta version of
  706.              this tool will not be recognized by this version of
  707.              the packager.
  708.  
  709.          5.  Cosmo Package strips whitespace from directory index
  710.              filenames, mappings, and trusted references.  This may
  711.              make it difficult to use directories containing
  712.              whitespace in their names.
  713.  
  714.          6.  Cosmo Package may cause your system to run out of swap
  715.              space.  If this happens, you will probably get a
  716.              system error dialog.  Running out of swap space may
  717.              cause the application to crash, may prevent some media
  718.              conversions from being done, or may prevent you from
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                   - 12 -
  731.  
  732.  
  733.  
  734.              launching a browser for previewing. If this occurs,
  735.              consider closing down other applications or adding
  736.              more swap space.
  737.  
  738.              To add swap space, choose "System->System Manager"
  739.              from the Toolchest.  On 6.2, you can launch the swap
  740.              manager from the "Administration Tools" panel of the
  741.              system manager.  On 6.3, selecting "System
  742.              Performance" from the system manager will guide you
  743.              through adding swap space.  On either system, you can
  744.              look at the man page for "swap".
  745.  
  746.  
  747.        5.3.2  _V_R_M_L
  748.  
  749.  
  750.        5.3.2.1  _U_R_L__d_i_s_c_o_v_e_r_y   The packager searches for all urls
  751.        found in "url" fields of the various node types.  It does
  752.        not check to see what values might flow to those fields
  753.        through routes.  For instance, if a script generates urls
  754.        and routes them to url fields, the packager will not
  755.        discover these urls.  Similarly, if you have a PROTO and
  756.        route one of its event-ins to the url field of a texture
  757.        node, the URLs in given in uses of those protos will not be
  758.        found by the packager.
  759.  
  760.        A partial work around for these blind-spots is to use those
  761.        urls elsewhere.  For instance, put the urls in the texture
  762.        node of a shape which you arrange to never display. (One way
  763.        to avoid showing the shape is to put it under a switch and
  764.        set whichChoice -1).  This will at least ensure that the
  765.        urls are discovered by the packager and that their fiels are
  766.        packaged.  It will also patch the "fake" uses of the urls
  767.        based on where those files are mapped to.  It is only a
  768.        partial solution because you will still have to check that
  769.        the urls you use in your scripts and routes will properly
  770.        refer to the files once they've been packaged.
  771.  
  772.  
  773.        5.3.2.2  _M_e_d_i_a__C_o_n_v_e_r_s_i_o_n   The VRML packager's media
  774.        conversions are done "best effort".  If you are not happy
  775.        with the conversion done by the packager, you may do the
  776.        conversion yourself in your authored files or you may or
  777.        leave the files alone.  Here are the known problems:
  778.  
  779.  
  780.          1.  Movies
  781.  
  782.                 +o If you request that a movie be converted to MPEG,
  783.                   it may have its size changed by the converter. To
  784.                   avoid this resizing, don't request automatic
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                   - 13 -
  797.  
  798.  
  799.  
  800.                   conversion of your movie files.
  801.  
  802.  
  803.          2.  Image textures with alpha channels
  804.  
  805.              The VRML packager may drop alpha channel data in some
  806.              cases if you ask it to do conversions for you.
  807.              Notably:
  808.  
  809.                 +o (PNG --> GIF)
  810.                        We allow this, but any alpha data in the PNG
  811.                        is likely to be dropped.  (Ask yourself...
  812.                        why are you converting "away from" a media
  813.                        format which all VRML 2.0 browsers are
  814.                        required to support?)
  815.  
  816.                 +o (GIF --> PNG) and (GIF --> JPEG)
  817.                        We allow these conversions, but alpha data
  818.                        in your GIFs will be lost.
  819.  
  820.          3.  Audio
  821.  
  822.              Cosmo Package won't convert from audio files out of
  823.              MIDI or WAV format.
  824.  
  825.  
  826.        5.3.2.3  _F_i_l_e__S_u_f_f_i_c_e_s
  827.  
  828.          1.  Using the "Use .wrl suffix for VRML files" makes the
  829.              packager propose new filenames for VRML files which do
  830.              not end in ".wrl".  Even with this option enabled, you
  831.              can still override these recommended names with the
  832.              mappings.  Doing so is not recommended.  Without this
  833.              suffix, Netscape Navigator probably won't recognize
  834.              your content as VRML.
  835.  
  836.  
  837.        5.3.3  _H_T_M_L
  838.  
  839.  
  840.               1.  Server-side includes are not discovered or
  841.                   packaged.  For instance, "<!--#exec cmd="basename
  842.                   `pwd`"--></P>" looks like a simple comment to the
  843.                   HTML packager.
  844.  
  845.               2.  Image map files which are referenced other than
  846.                   as image maps may not be properly discovered and
  847.                   packaged.  We don't expect this to cause a
  848.                   problem since normal servers won't server image
  849.                   map files unless they are being used as image
  850.                   maps.
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                                   - 14 -
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.